home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / time / jpclock / jpclock.doc < prev    next >
Text File  |  1996-04-07  |  7KB  |  129 lines
  1. *****************************************************************************
  2.                                                                              
  3.                                 JPClock v1.2                                  
  4.                                                                              
  5.                      © Copyright 1989 by Jonathan Potter                     
  6.                                                                              
  7.                   Another fantabulous Public Domain release                  
  8.                                                                              
  9. *****************************************************************************
  10.  
  11. JPClock - the ultimate WorkBench clock!
  12.  
  13. USAGE : 
  14.         JPClock [FLAGS]
  15.  
  16.         Flags are:
  17.  
  18.         -a           : Set Alarm on
  19.         -atALARMTIME : Set Alarm time to ALARMTIME (HH:MM:SS or H:MM:SSC)
  20.         -dSECONDS    : Set Delay between updates to SECONDS seconds
  21.         -f           : Set Stay Front on
  22.         -ot          : Turn time display off
  23.         -oy          : Turn day display off
  24.         -od          : Turn date display off
  25.         -of          : Turn fast memory display off
  26.         -oc          : Turn chip memory display off
  27.         -ol          : Turn total memory display off
  28.         -s           : Auto swap to next screen
  29.         -u           : USA format; MM-DD-YY instead of DD-MM-YY
  30.         -xX          : Open window with x-coordinate X
  31.         -yY          : Open window with y-coordinate Y
  32.  
  33. Since the Amiga's conception, there have been umpteen different clock
  34. programmes to go with it. The first of these, of course, was the WorkBench
  35. Clock, and other (third-party?) clocks have followed suit. Each one offered
  36. slightly different features; all (of course) showed time, some showed free
  37. memory in the system, and some showed the date. However, I have never found
  38. a clock programme that is quite flexible enough, with enough features for me.
  39. Enter JPClock!
  40. JPClock is quite a short clock programme, around 17K long, however it is
  41. packed with features. On first appearance, it looks just like any other
  42. clock, with maybe a little more. A title bar-height window opens at the
  43. top of the WorkBench screen, displaying the following information
  44.  
  45.       TIME      DAY DATE      FAST  CHIP  TOTAL
  46.  
  47. in the following format
  48.  
  49.       HH:MM:SS  DDD DD-MM-YY  XXXX  XXXX  XXXX
  50.  
  51. (note, as yet I have not found another clock programme that gives all this
  52. information.) Quite simply, TIME is the current time, DAY is the day of the
  53. week, and DATE is the date. Note that by specifying the -u flag when running
  54. JPClock, DATE is displayed in the USA format of MM-DD-YY. FAST is the amount
  55. of free FAST memory in the system, likewise CHIP is the amount of free CHIP
  56. memory in the system, and TOTAL is the two added together.
  57. Activating the JPClock window (which can be closed, dragged and depth
  58. arranged) by clicking on it, and then pressing the RIGHT MOUSE BUTTON,
  59. POPs open a larger window with several gadgets in it. Specifically, these
  60. gadgets are TIME, DATE, ALARM, NEXT SCREEN, STAY FRONT, and ALARM ON.
  61. TIME allows you to set the system time from within JPClock - simply click in
  62. the string gadget and type the time in (in the format HH:MM:SS). Note that
  63. the last two values are optional, however, to change the second or third
  64. value (minutes or seconds) you must specify the preceding values.
  65. DATE similarly allows you to set the system date, in the format DD-MM-YY
  66. (or MM-DD-YY in -u USA mode). Note please that JPClock is not capable of
  67. handling years past 1999, although it will not crash, the aesthetic balance
  68. of the clock will be disturbed. I have no doubts, however, that by 1999 much
  69. more sophisticated clocks will be available (if not computers) :-).
  70. ALARM allows you to set the Alarm time, ie the time at which the alarm, if
  71. enabled by the ALARM ON gadget, rings. The alarm ring is simply 10
  72. DisplayBeeps (screen flashes), accompanied by ten beeps.
  73. NEXT SCREEN allows you to shove the clock window to the next open screen.
  74. The window will not move if there is no next screen, or if the next
  75. screen is not big enough (minimum dimensions are 504x45.)
  76. STAY FRONT, when switched on (highlighted), will keep the JPClock window
  77. at the front of the display at all times. This means that you can never
  78. lose it behind other windows.
  79. ALARM ON, as explained before, allows you to switch the alarm on or off.
  80.  
  81. The fourteen startup flags allow to to change the way JPClock is configured.
  82. The flag -d allows you to change the delay between updates, and
  83. therefore, the accuracy of the clock. -dSECONDS sets the clock to one update
  84. every SECONDS seconds, where SECONDS is a number from between 1 and 10.
  85. The more time between updates, the less CPU cycles the clock will steal.
  86. The -f flag allows you to automatically set the STAY FRONT option
  87. on; this is identical in effect to turning it on manually by clicking on the
  88. gadget.
  89. Similarly, the -a flag allows you to turn the ALARM on.
  90. The -u flag allows you to set USA date mode on; ie dates will be displayed
  91. (and expected to be entered) in the form MM-DD-YY, as opposed to the DD-MM-YY
  92. format.
  93. The -o flags allow you to turn various displays in the clock off.
  94. -ot turns the time display off.
  95. -oy turns the day display off.
  96. -od turns the date display off.
  97. -of, -oc and -ol turn fast, chip and total memory display off.
  98. Note that you cannot turn everything off; if everything is turned off, time
  99. is automatically turned back on. The clock window size is changed depending
  100. on how much information is displayed.
  101. The -s flag allows you to automatically shove the clock window to the next
  102. next; of course, if there is no next screen, or the next screen is too
  103. small, it will not move.
  104. The -at flag, followed by a time in the form HH:MM:SS will set the Alarm time
  105. to the time specified.
  106. The -x and -y flags allow you to specify which position the JPClock window
  107. will open in initially; these values default to 70 and 0. -xX and -yY opens
  108. the window with coordinates X,Y.
  109.  
  110. Please enjoy JPClock, and do not use it for any evil purposes (huh?..)
  111.  
  112. In case you feel the urge to correspond with me, my address is
  113.  
  114.    3 William Street
  115.    Clarence Park
  116.    South Australia, 5034
  117.    Australia
  118.  
  119. and as someone suggested I include it, my 'phone number is 08-293-2788.
  120.  
  121. Thanks to Torsten Lohr (Eitorf, West Germany) for bug reports.
  122.  
  123. Jon.
  124.  
  125. PS: JPClock is Public Domain, you may do whatever you like with it, however,
  126.     if you decide to sell it, at least leave my name in it.
  127.  
  128.                                   -JP-
  129.